package com.zijidelu.luframework.infrastructure.persistence.repository.core.criteria;

import com.baomidou.mybatisplus.core.conditions.query.QueryWrapper;
import com.baomidou.mybatisplus.extension.conditions.query.LambdaQueryChainWrapper;
import com.baomidou.mybatisplus.extension.conditions.query.QueryChainWrapper;
import com.baomidou.mybatisplus.extension.conditions.update.LambdaUpdateChainWrapper;
import com.baomidou.mybatisplus.extension.conditions.update.UpdateChainWrapper;
import com.zijidelu.luframework.base.bizsig.BizSignature;
import com.zijidelu.luframework.base.model.DataModel;
import com.zijidelu.luframework.base.model.PO;

import java.util.Collection;

/**
 * 业务签名数据仓接口。
 *
 * @author ZIJIDELU
 * @date: 2024/3/21 22:10
 */
public interface BizSigPersistenceContext<P extends PO, D extends DataModel> {
    /**
     * 获取业务签名查询链式包装器
     *
     * @param dto dto
     * @return lambda查询链式包装器
     */
    QueryWrapper<P> buildBizSigQuery(BizSignature<D> bizSignature, D dto);

    /**
     * 获取业务签名查询链式包装器
     *
     * @param dto dto
     * @return 查询链式包装器
     */
    QueryChainWrapper<P> buildBizSigQueryChain(BizSignature<D> bizSignature, D dto);

    /**
     * 获取业务签名lambda查询链式包装器
     *
     * @param dto dto
     * @return lambda查询链式包装器
     */
    LambdaQueryChainWrapper<P> buildBizSigLambdaQueryChain(BizSignature<D> bizSignature, D dto);

    /**
     * 获取业务签名更新链式包装器
     *
     * @param dto dto
     * @return 更新链式包装器
     */
    UpdateChainWrapper<P> buildBizSigUpdateChain(BizSignature<D> bizSignature, D dto);

    /**
     * 获取业务签名lambda更新链式包装器
     *
     * @param dto dto
     * @return lambda更新链式包装器
     */
    LambdaUpdateChainWrapper<P> buildBizSigLambdaUpdateChain(BizSignature<D> bizSignature, D dto);

    /**
     * 获取精确业务签名查询包装器（使用OR条件）
     * <p>
     * 适用于需要精确匹配完整业务签名的场景，生成的SQL类似：WHERE (field1=1 AND field2='a') OR (field1=2 AND field2='b')
     *
     * @param dataColl 数据集合
     * @return lambda查询链式包装器
     */
    QueryChainWrapper<P> buildPreciseBizSigQueryChain(BizSignature<D> bizSignature, Collection<D> dataColl);

    /**
     * 获取精确业务签名查询包装器（使用OR条件）
     * <p>
     * 适用于需要精确匹配完整业务签名的场景，生成的SQL类似：WHERE (field1=1 AND field2='a') OR (field1=2 AND field2='b')
     *
     * @param dataColl 数据集合
     * @return lambda查询链式包装器
     */
    LambdaQueryChainWrapper<P> buildPreciseBizSigLambdaQueryChain(BizSignature<D> bizSignature, Collection<D> dataColl);

    /**
     * 获取业务签名lambda查询链式包装器
     * <p>
     * 模糊查询数据集合每个对象业务签名数据
     *
     * @param bizSignature 业务签名
     * @param dataColl     数据集合
     * @return lambda查询链式包装器
     */
    QueryChainWrapper<P> buildBizSigQueryChain(BizSignature<D> bizSignature, Collection<D> dataColl);

    /**
     * 获取业务签名lambda查询链式包装器
     * <p>
     * 模糊查询数据集合每个对象业务签名数据
     *
     * @param bizSignature 业务签名
     * @param dataColl     数据集合
     * @return lambda查询链式包装器
     */
    LambdaQueryChainWrapper<P> buildBizSigLambdaQueryChain(BizSignature<D> bizSignature, Collection<D> dataColl);

}
